home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / bbsc61.zip / BBSCHAT.DOC next >
Text File  |  1996-05-26  |  13KB  |  361 lines
  1.  
  2.                                 BBSCHAT
  3.  
  4.  
  5.                               Version 6.1
  6.  
  7.  
  8.  
  9.                       Written by Matthew Probert
  10.  
  11.  
  12.                      Published by Servile Software
  13.  
  14.  
  15.  
  16.  
  17. NOTE:
  18.  
  19. Two executable files are supplied in the package: BBSCHAT.EXE and 
  20. FSCHAT.EXE. FSCHAT.EXE will make use of ANSI to provide a nice split 
  21. screen environment. BBSCHAT.EXE will work even if the caller does not 
  22. support an ANSI terminal. Throughout this document you may optionally 
  23. replace "bbschat" with "fschat", the programs are otherwise identical. 
  24.  
  25.  
  26.  
  27. DESCRIPTION:
  28.  
  29. BBSChat is a PC BBS chat door system for BBS which generate a DOOR.SYS 
  30. file - such as Remote Access for example. BBSChat is loosely based 
  31. upon the BBS door "SHAMpage" by Rich Waugh of Drawbridge BBS. SHAMpage 
  32. response files may be used with only slight modification by BBSChat. 
  33. (See CONVERTING FROM SHAMPAGE TO BBSCHAT). 
  34.  
  35. Although I have been developing computer conversation systems for a 
  36. couple of years, I decided to clone SHAMpage because although its 
  37. good, I was frustrated by the limitations imposed by it which made it 
  38. too obviously a computer, the logoff screen with its copyright message 
  39. for a start! 
  40.  
  41. There are two ways of looking at BBSChat. Firstly as entertainment. 
  42. Secondly as a system for experimenting with Turing's theory of 
  43. thinking computers. By careful selection of responses and key words, a 
  44. configuration can be developed which appears to be quite intelligent. 
  45. However, BBSChat is still only a slot-and-frame parser! 
  46.  
  47. IMPORTANT: BBSChat will make use of ANSI if the caller has it enabled, 
  48. but if not will work perfectly well in monochrome. No sysop 
  49. adjustments are necessary. 
  50.  
  51.  
  52. IN BRIEF:
  53.  
  54. BBSChat is started from the command line with two required parameters 
  55. and two optional parameters. The first parameter is the name and path 
  56. to your BBS information file; DOOR.SYS. The second parameter is the 
  57. path and name to the configuration file to use for this personality. 
  58. For example: 
  59.  
  60. BBSCHAT C:\RA\DOOR.SYS HARRY.CFG [port][fossil]
  61.  
  62. IMPORTANT! BBSChat will assume that COM1 = 03F8 IRQ 4, COM2 = 02E8 
  63. IRQ3, COM3 = 03E8 IRQ4 and COM4 = 02E8 IRQ 3 These are the standard 
  64. COM port addresses and IRQ levels. 
  65.  
  66. Upon starting, BBSChat may display "Paging <name>" if the paging 
  67. option is active in the configuration file, and there is then a 
  68. randomly generated delay before the conversation commences by 
  69. displaying one of the "opening lines" selected at random. The user and 
  70. the computer then take turns to present typed text to each other, like 
  71. a conversation. BBSChat responds through "replies" contained in the 
  72. configuration file which are selected based upon matching of key words 
  73. and phrases in the users input with those contained in the data file. 
  74.  
  75. Keywords are matched on a first come first served basis. So specific 
  76. keyword phrases should occur at the start of the data file, with more 
  77. general keywords towards the end. 
  78.  
  79. Should the user not make any keyboard entry for 5 minutes, or if the 
  80. user's allocated time expires BBSChat will terminate and return to the 
  81. BBS. 
  82.  
  83. If the caller has ANSI enabled, BBSChat will display the caller's 
  84. prompts and text in yellow, and the computers's in cyan. Otherwise 
  85. both will be in monochrome. BBSChat detects and adjusts for the 
  86. caller's ANSI settings automatically. 
  87.  
  88. The results of the conversation are added to the end of the file 
  89. "chat.log" in the current directory. 
  90.  
  91. LIMITS:
  92.  
  93. Opening lines           50
  94. No match responses      100
  95. Data blocks             300
  96. Aliases                 10 per data block
  97. Responses               20 per data block
  98.  
  99.  
  100.  
  101. VARIABLES:
  102.  
  103. Within the reply text in the data file various variables may be 
  104. included which will be expanded during the conversation. 
  105.  
  106. *DELAY*         Pause for one second
  107. *END*           Force end of conversation, displaying "fed up message".
  108. *USER*          Caller's first name
  109. *CITY*          Caller's city
  110. *PHONE*         Caller's home phone number
  111. *LAST*          Last phrase (thread) output by the computer
  112. *SEC*           The caller's security level
  113. *TIME*          Current time is inserted
  114. *LF*            Line is split, carriage return and line feed inserted
  115. *TIMEOFDAY*     MORNING, AFTERNOON or EVENING inserted as appropriate
  116. *timeofday*     morning, afternoon or evening inserted as appropriate
  117. *Keyword*       The matched keyword is inserted with first letter capitalised
  118. *KEYWORD*       The matched keyword is inserted capitalised
  119. *keyword*       The matched keyword is inserted as it was typed by the user
  120. *Object*        The object is inserted with first letter capitalised
  121. *OBJECT*        The object is inserted capitalised
  122. *object*        The object is inserted as it was typed by the user
  123. *next*          The word following the last matched keyword is inserted as
  124.                 it was typed by the user
  125.  
  126. DATA FILE STRUCTURE:
  127.  
  128. ; optional comment lines
  129. N       Number of opening lines
  130. XXXX    Opening line 1
  131. XXXX    Opening line 2
  132. ; Then the "no match responses"
  133. NOMATCH
  134. N       Number of responses for non-matched words
  135. XXXX    Non-matched response 1
  136. XXXX    Non-matched response 2
  137. ; Finally the data blocks
  138. THREAD  The last phrase the computer output (maximum of 80 characters)
  139. KEYWORD Keyword or phrase
  140. *ALIAS* An alias key word for this section 
  141. N       Number of responses in this section
  142. XXXX    Response 1
  143.  
  144. Please refer to the supplied demonstration file 'HARRY.DAT' for an 
  145. example of the data file in practice. 
  146.  
  147. Replies are what BBSChat will display in response to user entered data 
  148. and are terminated by a carriage-return/line feed in the configuartion 
  149. file. Keywords and aliases MUST be in upper case Any line commening 
  150. with ; is ignored. Variables may be inserted in any response, except 
  151. that: keyword variables may not be used in either opening or non-
  152. matched responses 
  153.  
  154.  
  155. When the user enters some text, BBSChat searches the text for each 
  156. keyword and then associated aliases in turn. Keywords/aliases are 
  157. matched if they occur in the entered text. So it is important to 
  158. include spaces around words you want to match in full, for example: 
  159.  
  160. NO will match with NO, NOW, NOTHING etc
  161. but
  162. " NO " will only match with NO
  163.  
  164. Keywords/aliases may be multiple words, and quote marks are ignored, 
  165. eg: 
  166.  
  167. "WHAT IS THE TIME"
  168.  
  169. When BBSChat matches a keyword/alias it ouputs one of the recorded 
  170. responses at random. That response is then deleted from memory. If 
  171. there are no responses to be made, BBSChat searches for the next 
  172. matching keyword or phrase. When all matching keywords have been 
  173. exhausted a NOMATCH response is selected at random and output. If 
  174. there are no responses left to be made, BBSCHAT terminates the 
  175. conversation. If a match cannot be made with the users input, one of 
  176. the NOMATCH responses is output in the same way. 
  177.  
  178. For example:
  179.  
  180. Consider a simple personality file thus:
  181.  
  182. ;----------------------------------------------------------------------------
  183. ;
  184. ; These are the opening lines which are generated randomly.
  185. ;
  186. ;----------------------------------------------------------------------------
  187. 3
  188. Opener 1
  189. Opener 2
  190. Opener 3
  191. ;----------------------------------------------------------------------------
  192. ;
  193. ; These are lines sent when no keyword match occurs.
  194. ;
  195. ;----------------------------------------------------------------------------
  196. NOMATCH
  197. 5
  198. Random 1
  199. Random 2
  200. Random 3
  201. Random 4
  202. Random 5
  203. ;----------------------------------------------------------------------------
  204.  
  205. LIFE
  206. 3
  207. Life response 1
  208. Life response 2
  209. Life response 3
  210. ;----------------------------------------------------------------------------
  211.  
  212.  
  213. BITCH
  214. 3
  215. Bitch response 1
  216. Bitch response 2
  217. Bitch response 3
  218.  
  219. When the human caller enters the phrase "Life's a bitch", BBSCHAT will search 
  220. and make a match on the word "LIFE" and ouput one of the three life responses 
  221. at random. The second time the caller enters the phrase one of the remaining 
  222. two life responses will be output and so on. When all three life responses 
  223. have been output